--------------------------------------------------------------------
                  -- Pattern Generator V 1.2 --
--------------------------------------------------------------------


Content:
-------------------------------------------------
-- Quick Info
-- Installation
-- Trial Version
-- Registration

-- Quick start and instruction:
-------------------------------
-- Moving within model
-- Manipulate objects
-- Build terrain
-- Generate Buildings
-- Building-complex
-- Open spaces
-- Screenshot
-- Save model
-- Publish model

-- Thank you
--------------------------------------------------


  Quick Info:
  -----------

Parametrise, generate and manipulate.

The Pattern Generator is a simple to use software to quickly design and build urban and topographical structures within a 3D environment. 
Publish your own models on the internet (Shockwave) or use the lingo-code to change models and integrate them into your own projects.

This software runs under Windows (developed and tested on XP).
Programmed and designed with Macromedia Director Shockwave Studio 8.5.


  Installation:
  -------------

No installation necessary. 
Unzip and place the folder "Pattern Generator" with all its content anywhere on your harddisc and start the programm by doubleclick on "Pattern Generator.exe".


  Trial Version:
  --------------

The trial version is fully functional with no restrictions. 
If not registered, there will be an reminder every 15 minutes.
 

  Registration:
  -------------

The Pattern Generator is shareware.
Feel free to register your copy for 20 Euro at "http://www.pattern-generator.com". 
The software is sold as is.
Thank you :-)





               Quick start and instruction:
------------------------------------------------------------------------------


Moving within model:
--------------------

Start of by opening a saved model and try to move around the model and walk through:

You can adjust the size of the 3D-Stage by pulling out the bottom, right corner.

Walk on terrain:  Use arrow keys (alternative Keys: W, D, S, A)
Turn to the left and right, look up and down:  Move mouse in window

Zoom: Ctrl & MouseDown
Pan: Shift & MouseDown
Rotate: Alt & MouseDown


Drag the yellow ball from a top view to change your position within the model. 
If the yellow ball gets stuck under a building (no movement with arrow keys possible), then zoom out and drag the ball with the mouse to an open space. Press any arrow key to zoom back in and change to the human perspective.
------------------------------------------------------------------------------


Manipulate objects:
-------------------

Double Click any object to select buildings and open spaces and drag them around from a top view perspective. Double Click again to unselect.

Open palette "Manipulate objects" and use sliders to change the dimensions of selected objects. 

Klick airbrush to generate buildings within the 3D environment and use eraser to delete single buildings.

The half transparent, grey square marks the current active building area. When generating buildings or open spaces, they will be randomly set within only this area. Use sliders in palette "Manipulate Objects" to change dimensions of the building site, drag it around with the mouse or hide if desired.
------------------------------------------------------------------------------


Build terrain:
----------------

Start new project by pressing button "new model" or restart software.

Open palette "load terrain", drag the greyscale-image to the desired area and press "update topograpy" to rebuild your terrain. Any existing objects will be adjusted to the new heights.

Prepare and load your own jpg-images.
------------------------------------------------------------------------------


Generate Buildings:
-------------------

Open palette "building" and press button "generate" several times. 
Within the area of the building site (half transparent, grey square) your buildings will randomly set according to the presets of the sliders (amount, dimensions, rotation).
Play around with the sliders to get different structures and ideas and freeze any state you like.
------------------------------------------------------------------------------


Building-complex:
-----------------

Press button "builing-complex" at the bottom of the builing-palette.
You can adjust the amount of buildings that are suposed to be arrangend in groups.
Adjust the spacing between the buildings within the groups and complexes.
Press button "generate" again on the building-palette and watch the results.
------------------------------------------------------------------------------


Open spaces:
------------

Open palette "open spaces" and generate areas, which will stay vacant.
When closing this palette your open spaces will become invisible, but stay active. No buildings will be set within these areas.


If open spaces or buildings are selected, they will be magnetic for any further buildings to be generated (freeze first, otherwise they will be deleted)
------------------------------------------------------------------------------


Screenshot:
-----------

To save images of your model please use the screenshot-function on your keyboard and an image editing tool. 
Scale up the stage and move into the desired perspective. Open palette "screenshot" and press button "Anti-alias" to improve the quality of display, before taking the picture.
------------------------------------------------------------------------------


Save model:
-----------

You can save your models and continue work later or publish them as shockwave-movie on the internet.
The model-data is generated as lingo code and saved as txt-file.
The text-file includes all lingo to build up the whole 3D-world as a static model, including texture-bitmaps and terrain information. Just copy this text into your director projekt and execute it as lingo. You will have the static modell and you can continue work on it within macromedia director (scripting for interaction >moving within modell< is not included).
------------------------------------------------------------------------------


Publish model:
--------------

You can publish your model on the gallery-page at www.pattern-generator.com. Klick the link within the software and follow the instructions on the web-page when clicking "upload".

To publish your walk-through model as shockwave-movie on your own web-page, use the included shockwave-file "pg_publish.dcr". This file will read your model-data from the txt-file and display it in any browser with the shockwave-plugIn istalled.

Instructions:
To Publish, you need to put the following three files onto an internet-server (included with the software in the folder "publish"):


--  pg_publish.dcr
------------------
This is the emtpy shockwave-file to display a Pattern Generator model in a browser.


--  modell_name.txt
-------------------
This text-file includes only the name of the model that is supposed to be displayed. For examle: "my_model_xxx_mdl.txt"


--  my_model_xxx_mdl.txt
------------------------
This is the text-file with the model-data you have saved with the pattern generator.


Please note: Publishing does not work, when testing locally (error message). The model gets only displayed, when it is on an internet-server. Don`t ask me why ;-(   
-- that`s how it is for the time being. Just remember and don`t be frustrated if it does not work, while testing from your local harddisc. 
Maybe someone can give me a hint, where the problem is: Using "getNetText" and "netTextResult"...

------------------------------------------------------------------------------



Thank you for your interest: Valentin Hadelich, Philip Gaedke


The Pattern Generator was a project at the Bauhaus-Universaty Weimar - faculty of architecture in spring 2002.

http://infar.architektur.uni-weimar.de/infar/deu/projekte/planungssysteme/pattern106/index.html


Lingo-programming: Philip Gaedke > http://www.rasterball.de
Web-Page: Valentin Hadelich > valentin@hadelich.de







